home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr33 / pgpshel2.zip / PGPSHELL.DOC < prev    next >
Text File  |  1993-05-13  |  15KB  |  349 lines
  1.  
  2.  
  3.                               -= PGPShell =-
  4.  
  5.  
  6.  
  7.              Official Menu-Driven Shell of the 1996 Olympics!
  8.  
  9.            Endorsed by the Saddam Hussein Downhill Ski Team, the
  10.             National Security Agency, and the Captain Midnight
  11.                      "Secret Decoder Ring" Fan Club
  12.  
  13.  
  14.                     (c) copyright by James Still 1993
  15.                   of the Hieroglyphic Voodoo Machine BBS 
  16.                     in snowy Boulder, Colorado, U.S.A. 
  17.                             All Rights Reserved
  18.  
  19.  
  20.           PGPShell v 2.0 is released as freeware on May 19, 1993
  21.  
  22.  
  23.           Pretty Good Privacy (PGP) is (c) copyrighted 1990-1992
  24.                            by Philip Zimmermann
  25.  
  26.  
  27.  
  28. WARRANTY
  29. -------------------------------------------------------------------------
  30.  
  31. Nope!  Use at your own risk.  James Still (and his evil twin Johannes 
  32. Kepler) disclaim all warranties, expressed or implied, including without
  33. limitation, the warranties of use and/or fitness of PGPShell for any
  34. purpose.  James Still assumes no liabilities for damages, direct or
  35. consequential, which may result from the use or misuse of PGPShell.
  36. PGPShell is FREEWARE which means you may use it without charge for as 
  37. long as you want to, even on Mars, and 53 miles west of Venus if you
  38. should so desire.  However, James Still retains all rights to the 
  39. copyright of PGPShell versions 1.0 and 2.0.  When they make a movie of
  40. it someday, I want to be there to say "No, no, the menu structure didn't
  41. look like that at all!"
  42.  
  43.  
  44.  
  45.  
  46. QUICK START
  47. --------------------------------------------------------------------------
  48.  
  49. Create a C:\PGPSHELL directory and copy PGPSHELL.EXE into that directory.
  50. Run PGPSHELL.  Use the ESC, ENTER, arrow keys, and TAB key to manually
  51. navigate around PGPShell, or use your mouse if it is installed.
  52.  
  53.  
  54.  
  55.  
  56. INTRODUCTION
  57. --------------------------------------------------------------------------
  58.  
  59. PGPShell version 2.0 is a menu-driven front-end that makes Phil
  60. Zimmermann's excellent program Pretty Good Privacy (PGP) easier to manage
  61. and use.  Use it instead of PGP to make your encryption life easier!
  62. Improvements over the first version are too numerous to go into fully as
  63. 2.0 is practically a complete rewrite, but the biggies are:  GUI and
  64. mouse driver, full support of all PGP commands, expanded sub-menu for key
  65. management with logically arranged "drop-down" menus, plaintext file
  66. viewer, text editor interface, and a helpful public key userID directory.
  67.  
  68. For the public key encryption novice, PGPShell should be a perfect
  69. introduction to the exciting and wacky world of (what Andy Hawks coined
  70. in a recent Future Culture FAQ) "Cypherpunk."  (Kinda catchy ain't it?  
  71. What'll they think of next...<g>)
  72.  
  73. You should make sure that the executable file is a good one by looking at
  74. the date and time stamp.  From the DOS prompt type "dir PGPSHELL.EXE" and
  75. you should see this:
  76.  
  77.              PGPSHELL EXE       119984   05-12-93    3:31p
  78.  
  79. If it says anything else I didn't compile it!  Granted some ex-KGB agent
  80. could set his computers date and time, and the file size, but hey who's
  81. that paranoid?  Nevertheless if you don't trust it, call up the 
  82. Hieroglyphic Voodoo Machine BBS at 1.303.443.2457 and download yourself a 
  83. fresh, clean copy.
  84.  
  85.  
  86.  
  87. GETTING STARTED
  88. --------------------------------------------------------------------------
  89.  
  90. These title heads are starting to look like an old WordPerfect manual eh?  
  91. PGPShell is DOS-only which means that I don't know how to port this to 
  92. UNIX.  UNIX-guru's can write their own scripts in PERL and abhor the 
  93. heresy's of mouse drivers so I think its safe to assume that they won't 
  94. be joining us anyway.  Okay to get things set up, from the root directory
  95. (C:\) of DOS enter these commands:
  96.  
  97.                           md pgpshell
  98.                           cd pgpshell
  99.  
  100. Then copy the PGPSHELL.EXE file and any other related docs, into the
  101. PGPSHELL directory.
  102.  
  103. Type PGPSHELL at the DOS prompt to execute the program.  If you have NOT 
  104. previously installed PGP on your system, PGPShell will bug you with some 
  105. questions.  If you have never set the environment variables for PGP in 
  106. your AUTOEXEC.BAT file, PGPShell will not know where PGP is and get real 
  107. confused!  PGPShell will ask you to point out your PGP directory so that 
  108. it can run correctly.  If you want, PGPShell will even add those 
  109. environment variable lines to your AUTOEXEC.BAT file for you (first 
  110. creating a backup of your AUTOEXEC.BAT file and calling it AUTOEXEC.PGP).
  111.  
  112. See the PGP documentation for more information about setting up the PGP
  113. environment variables.
  114.  
  115.  
  116.  
  117. MAIN MENU
  118. --------------------------------------------------------------------------
  119.  
  120. In the wonderful world of cryptography, text files or "messages" are of 
  121. two types:  plaintexts and ciphertexts.  Plaintexts are unencrypted and,
  122. you guessed it, ciphertexts are encrypted.
  123.  
  124. The main menu consists of these options in handling plain/ciphertexts:
  125.  
  126.  
  127.              ■  Compose a Plaintext for Encryption
  128.              ■  View a Plaintext on Screen
  129.              ■  Encrypt a Previously Written Plaintext
  130.              ■  Decrypt a Ciphertext
  131.              ■  Archive a File
  132.              ■  Key Ring Menu
  133.  
  134.  
  135.     COMPOSE A PLAINTEXT
  136.     ~~~~~~~~~~~~~~~~~~~
  137.     To write a message for encryption to someone, choose this option.
  138.     Assuming you have not deleted or moved your text editor, PGPShell
  139.     will bring up your text editor for use.  By default it names your
  140.     message "MESSAGE.TXT" but it is likely you will want to save it by
  141.     another file name.
  142.  
  143.  
  144.     VIEW A PLAINTEXT
  145.     ~~~~~~~~~~~~~~~~
  146.     PGPShell contains a built-in viewer to allow you to read your
  147.     decrypted messages as long as they are less than 30K in size.  The
  148.     reason for this is that bugaboo called 'memory.'  PGP is a memory hog
  149.     (unless you use EMM386 or manage memory through Windows) and PGPShell
  150.     is another memory hog with its new GUI facelift.  I'm not sure just
  151.     how large a text file you can cram in there, but 30K seemed a nifty
  152.     ceiling.  Besides if you sent a love letter over 30K, you'd bore them
  153.     to tears and they'd never speak to you again.
  154.  
  155.  
  156.     ENCRYPT A PREVIOUSLY WRITTEN PLAINTEXT
  157.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  158.     There are five options in an Encryption Dialogue box for you to choose
  159.     from when encrypting a plaintext file.  I'll list them and the PGP 
  160.     argument in parenthesis after:
  161.  
  162.         1) Radix-64 ASCII e-mail format                  (-a)
  163.         2) Sign the plaintext with your secret key       (-s)
  164.         3) Wipe or "shred" the original after encrytion  (-w)
  165.         4) Convert plaintext to canonical text           (-t)
  166.         5) Force recipient to view "on-screen" only      (-m)
  167.  
  168.     Consult the PGP documentation for more details on what these parameters
  169.     are used for when encrypting plaintexts from within the PGPShell.
  170.  
  171.  
  172.     DECRYPT A CIPHERTEXT
  173.     ~~~~~~~~~~~~~~~~~~~~
  174.     As with the encryption options, there are five decryption options that
  175.     you may toggle in a Decryption Options dialogue box.  They are:
  176.  
  177.         1) Check the signature authority of the ciphertext  (-o)
  178.         2) Detach a signature certificate from a ciphertext (-b)
  179.         3) Leave the signature on the ciphertext intact     (-d)
  180.         4) View the ciphertext "on-screen" only             (-m)    
  181.         5) Keep the original filename on the ciphertext     (-p)
  182.  
  183.     Again, consult the PGP documentation for detailed help with these
  184.     arguments.
  185.  
  186.  
  187.     ARCHIVE A FILE
  188.     ~~~~~~~~~~~~~~
  189.     This is the -c argument in PGP.  Sometimes you may just want to 
  190.     conventionally encrypt a file, or any number of files, for your own
  191.     backup and security purposes.  Keep in mind that PGP will ask you 
  192.     for a pass phrase to encrypt the file with.  Its not a good idea to 
  193.     use your secret key pass phrase even though it may look like PGP is 
  194.     calling for that.  
  195.     
  196.  
  197.     KEY RING MENU
  198.     ~~~~~~~~~~~~~
  199.     Choosing this menu option, will take you to the key ring management
  200.     submenu.  The key ring menu is broken down into three sections:
  201.  
  202.         1) Access Key Ring Submenu (copy, view, add, remove keys)
  203.  
  204.         2) Access Certification Submenu (certify, signatures, etc.)
  205.  
  206.         3) Access Create/Revoke Submenu (edit UserID, revoke keys, etc.)
  207.  
  208.     These three options have hotkeys assigned to them which are 1, 2, and
  209.     3, and are shown on the menu at the left side of the menu.  To leave  
  210.     the Key Ring Menu or any of its submenus, just slap the Escape key.
  211.  
  212.     Take a peek at the PGP documentation for more detailed information
  213.     on what the various -k (key arguments) are.  I could repeat them 
  214.     here, but if you have this shell, then you have PGP too!  
  215.     
  216.  
  217.  
  218. THINGS WORTH MENTIONING
  219. -------------------------------------------------------------------------- 
  220.  
  221. As I mentioned in "Getting Started" above, when you first start PGPShell, 
  222. the first thing it does is look for your AUTOEXEC.BAT so it can find out 
  223. where your PGP directory is.  After its done that, it will create its 
  224. PGPSHELL.CFG file if it hasn't already.  (This will only happen once when 
  225. you first run PGPShell.)  Last, it looks at your PUBRING.PGP public key 
  226. ring to make a list of all of the first names of the UserID's on your key 
  227. ring.  Whenever you execute a command from within the shell, it will first 
  228. display this list of UserID's in rows of four.  So if you have my public 
  229. key on your ring (Johannes Kepler) along with a few other friends, say 
  230. John Bigbooty (Big-Boo-TAY), Zaphod Bebblebrox, and Linda Lovelace, it will 
  231. display like this:
  232.  
  233.         Johannes        John          Zaphod          Linda
  234.        Your Name
  235.  
  236. This will be displayed at the top of every PGP execution so that you have 
  237. instant access to message recipients and their names.
  238.  
  239. Each time you execute a PGP command, this list gets updated.  You'll see a 
  240. brief flash (depending on how fast your computer is) with the PGP copyright 
  241. notice/blurb and then the menu will appear again.  This is PGPShell running 
  242. the -kv (key view) argument to keep the list updated after key removals, 
  243. additions, etc.  You'll also see the PGP blurb right at the beginning when 
  244. you first start PGPShell.  
  245.  
  246. If you see this message: "No Key Ring!" instead of Johannes, Zaphod, etc., 
  247. it means you either haven't created a PUBRING.PGP key ring, or PGPShell 
  248. can't find your PGP directory.  If you haven't created a unique key pair, 
  249. select Key Ring Menu item #3 (Access Create/Revoke Keys) and choose 
  250. "Create a Public/Secret Key Pair" to make them.  If you've never used PGP 
  251. before, this is the first thing you should do.  The second thing is add 
  252. (or let PGPShell add) the environment variables to your AUTOEXEC.BAT file.
  253.  
  254.  
  255.  
  256. WINDOWS AND NETWORKS
  257. ----------------------------------------------------------------------------
  258.     
  259. You can run PGPShell in Windows by setting up a PIF file with low graphics, 
  260. run in the foreground, etc.  Be careful about running PGP or PGPShell on a 
  261. network however, since certain drivers can conflict with PGP.  I've found 
  262. that Pathway Access' ODI and PWTCP drivers may lock up your computer if PGP 
  263. is executed.  If you have problems with network drivers I suggest playing 
  264. around with loading and unloading them high (@lh) and seeing what works 
  265. best.  Just remember that PGP is a 200K executable and PGPShell is about 
  266. 120K, so if there's not enough memory you might have to use one of the many 
  267. shareware programs that lets you choose a config upon startup.  For 99% of 
  268. the people out there this paragraph doesn't even apply so I wouldn't worry.
  269.  
  270.     
  271.     
  272. PGPSHELL CONFIG FILE
  273. ----------------------------------------------------------------------------
  274.     
  275. PGPShell creates its own configuration file "on the fly."  That is to say 
  276. that if it discovers that the PGPSHELL.CFG file is not in the current 
  277. directory, it will ask you two questions to create it.  The first question 
  278. is simply, "What is your name?"  If PGPShell knows your name, it can plug 
  279. that in when necessary instead of having PGP ask you just before doing a 
  280. step.  The other question is "What text editor do you want to use?"  A 
  281. directory dialogue box will pop up and ask you to choose one.  If you don't 
  282. have a favorite text editor just go into your \DOS directory and choose 
  283. EDIT.COM instead.  If in the future you decide you want another text editor 
  284. you can either manually change the PGPSHELL.CFG file or delete it and let 
  285. PGPShell create another one at start up.
  286.  
  287.  
  288.  
  289. CLOSING COMMENTS
  290. ----------------------------------------------------------------------------
  291.  
  292. PGPShell should be easy to use.  My hope is that more Windows-oriented 
  293. people will use PGPShell and subsequently PGP, just because of its ease of 
  294. use.  Privacy shouldn't be the exception, it should be the norm; and it 
  295. shouldn't be a hassle or only for the UNIX gurus!
  296.  
  297. If you have any questions or comments, please feel free to e-mail me on the 
  298. Internet at <still_j@cubldr.colorado.edu> or at the Voodoo Machine if 
  299. you're a BBSer.
  300.  
  301. Also included in this file is KEPLER.ASC which is my public key.  If you 
  302. want to get down to the business of public key encryption, ADD my key to 
  303. your public key ring and send me an encrypted e-mail message of what you do 
  304. or don't like about PGPShell.  It would be rewarding to hear from you about 
  305. what improvements in the future you would like or even what the weather is 
  306. like in your country.
  307.  
  308.  
  309.     
  310. REGISTRATION
  311. ----------------------------------------------------------------------------
  312.     
  313. Nope!  This is freeware.  Do me a favor and give a copy of PGPShell to at 
  314. least two of your co-workers, friends, enemies (why not?) and anyone else 
  315. who's interested in privacy.
  316.  
  317.  
  318.     
  319. CREDITS
  320. ----------------------------------------------------------------------------
  321.  
  322. Thanks to Technojock Software, Inc. for their toolkit that I horked to throw 
  323. this together.  I freely admit I didn't register it, but if you want to 
  324. acquire an excellent and comprehensive toolkit (I think its only $50) give 
  325. 'em a call on Compu$erve at 74017,227, or write:  P.O. Box 820927, 
  326. Houston, TX  77282-0927.  Thanks to everyone who wrote me about the first 
  327. version and gave me valuable suggestions.
  328.  
  329. Also thanks to Katherine, my future wife (in oh, about 20 days...) who puts 
  330. up with my strange ways, friends, and hours-long code sessions into the 
  331. night.  Then again she's kinda strange too...  
  332.         
  333. Visit Port Watson!  Ask Kevin how at <portwatson@firefly.rain.com> and tell
  334. him Johannes sent ya!
  335.  
  336. Bye!
  337.     
  338. -------------- EOF ---------------------------------------------------------
  339.  
  340.  
  341.     
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.